home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_ImageMagick.idb / usr / freeware / catman / u_man / cat1 / animate.Z / animate
Encoding:
Text File  |  1999-01-26  |  38.8 KB  |  859 lines

  1.  
  2.  
  3.  
  4.      aaaannnniiiimmmmaaaatttteeee((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    MMMMaaaayyyy 1111999999994444))))        aaaannnniiiimmmmaaaatttteeee((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       animate - display a sequence of images on any    workstation
  10.       running X
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       aaaannnniiiimmmmaaaatttteeee [[[[ _o_p_t_i_o_n_s ............]]]] _f_i_l_e [    [ _o_p_t_i_o_n_s ...] _f_i_l_e ...]
  14.  
  15.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.       aaaannnniiiimmmmaaaatttteeee displays a sequence of images    on any workstation
  17.       display running an X server.    aaaannnniiiimmmmaaaatttteeee    first determines the
  18.       hardware capabilities    of the workstation.  If    the number of
  19.       unique colors    in an image is less than or equal to the
  20.       number the workstation can support, the image    is displayed
  21.       in an    X window.  Otherwise the number    of colors in the image
  22.       is first reduced to match the    color resolution of the
  23.       workstation before it    is displayed.
  24.  
  25.       This means that a continuous-tone 24 bits-per-pixel image
  26.       can display on a 8 bit pseudo-color device or    monochrome
  27.       device.  In most instances the reduced color image closely
  28.       resembles the    original.  Alternatively, a monochrome or
  29.       pseudo-color image sequence can display on a continuous-tone
  30.       24 bits-per-pixel device.
  31.  
  32.       To help prevent color    flashing on X server visuals that have
  33.       colormaps, aaaannnniiiimmmmaaaatttteeee creates a single colormap from the    image
  34.       sequence.  This can be rather    time consuming.     You can speed
  35.       this operation up by reducing    the colors in the image    before
  36.       you `animate'    them.  Use mmmmooooggggrrrriiiiffffyyyy to color reduce the images
  37.       to a single colormap.     See mmmmooooggggrrrriiiiffffyyyy((((1111))))    for details.
  38.       Alternatively, you can use a _S_t_a_n_d_a_r_d    _C_o_l_o_r_m_a_p; or a static,
  39.       direct, or true color    visual.     You can define    a _S_t_a_n_d_a_r_d
  40.       _C_o_l_o_r_m_a_p with    _x_s_t_d_c_m_a_p.  See XXXXSSSSTTTTDDDDCCCCMMMMAAAAPPPP((((1111)))) for details.     This
  41.       method is recommended    for colormapped    X server because it
  42.       eliminates the need to compute a global colormap.
  43.  
  44.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  45.       To animate a set of images of    a cockatoo, use:
  46.  
  47.            animate cockatoo.*
  48.  
  49.       To animate a cockatoo    image sequence while using the
  50.       _S_t_a_n_d_a_r_d _C_o_l_o_r_m_a_p "best", use:
  51.  
  52.            xstdcmap    -best
  53.            animate -map best cockatoo.*
  54.  
  55.       To animate an    image of a cockatoo without a border centered
  56.       on a backdrop, use:
  57.  
  58.            animate +borderwidth -backdrop cockatoo.*
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 12/17/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      aaaannnniiiimmmmaaaatttteeee((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    MMMMaaaayyyy 1111999999994444))))        aaaannnniiiimmmmaaaatttteeee((((1111))))
  71.  
  72.  
  73.  
  74.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  75.       ----bbbbaaaacccckkkkddddrrrroooopppp
  76.            display the image centered on a backdrop.
  77.  
  78.            This backdrop covers the    entire workstation screen and
  79.            is useful for hiding other X window activity while
  80.            viewing the image sequence.   The color of the backdrop
  81.            is specified as the background color.  Refer to XXXX
  82.            RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for details.
  83.  
  84.       ----ccccoooolllloooorrrrmmmmaaaapppp _t_y_p_e
  85.            the type    of colormap: SSSShhhhaaaarrrreeeedddd or PPPPrrrriiiivvvvaaaatttteeee.
  86.  
  87.            This option only    applies    when the default X server
  88.            visual is _P_s_e_u_d_o_C_o_l_o_r or    _G_r_a_y_S_c_a_l_e.  Refer to ----vvvviiiissssuuuuaaaallll
  89.            for more    details.  By default, a    shared colormap    is
  90.            allocated.  The image shares colors with    other X
  91.            clients.     Some image colors could be approximated,
  92.            therefore your image may    look very different than
  93.            intended.  Choose PPPPrrrriiiivvvvaaaatttteeee and the image colors appear
  94.            exactly as they are defined.  However, other clients
  95.            may go "technicolor" when the image colormap is
  96.            installed.
  97.  
  98.       ----ccccoooolllloooorrrrssss _v_a_l_u_e
  99.            preferred number    of colors in the image.
  100.  
  101.            The actual number of colors in the image    may be less
  102.            than your request, but never more.  Note, this is a
  103.            color reduction option.    Images with less unique    colors
  104.            than specified with this    option will have any duplicate
  105.            or unused colors    removed.  Refer    to qqqquuuuaaaannnnttttiiiizzzzeeee((((9999)))) for
  106.            more details.
  107.  
  108.            Note, options ----ddddiiiitttthhhheeeerrrr, ----ccccoooolllloooorrrrssssppppaaaacccceeee, and ----ttttrrrreeeeeeeeddddeeeepppptttthhhh
  109.            affect the color    reduction algorithm.
  110.  
  111.       ----ccccoooolllloooorrrrssssppppaaaacccceeee _v_a_l_u_e
  112.            the type    of colorspace: GGGGRRRRAAAAYYYY, OOOOHHHHTTTTAAAA, RRRRGGGGBBBB,    TTTTrrrraaaannnnssssppppaaaarrrreeeennnntttt,
  113.            XXXXYYYYZZZZ, YYYYCCCCbbbbCCCCrrrr, YYYYIIIIQQQQ,    YYYYPPPPbbbbPPPPrrrr, YYYYUUUUVVVV, or CCCCMMMMYYYYKKKK.
  114.  
  115.            Color reduction,    by default, takes place    in the RGB
  116.            color space.  Empirical evidence    suggests that
  117.            distances in color spaces such as YUV or    YIQ correspond
  118.            to perceptual color differences more closely than do
  119.            distances in RGB    space.    These color spaces may give
  120.            better results when color reducing an image.  Refer to
  121.            qqqquuuuaaaannnnttttiiiizzzzeeee((((9999)))) for more details.
  122.  
  123.            The TTTTrrrraaaannnnssssppppaaaarrrreeeennnntttt color space behaves uniquely in that it
  124.            preserves the matte channel of the image    if it exists.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 12/17/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      aaaannnniiiimmmmaaaatttteeee((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    MMMMaaaayyyy 1111999999994444))))        aaaannnniiiimmmmaaaatttteeee((((1111))))
  137.  
  138.  
  139.  
  140.            The ----ccccoooolllloooorrrrssss or ----mmmmoooonnnnoooocccchhhhrrrroooommmmeeee option is required for this
  141.            option to take effect.
  142.  
  143.       ----ccccrrrroooopppp    <_w_i_d_t_h>{%}_x<_h_e_i_g_h_t>{%}{+-}<_x _o_f_f_s_e_t>{+-}<_y _o_f_f_s_e_t>
  144.            preferred size and location of the cropped image.  See
  145.            XXXX((((1111)))) for    details    about the geometry specification.
  146.  
  147.            To specify a percentage width or    height instead,    append
  148.            %%%%.  For example to crop the image by ten    percent    on all
  149.            sides of    the image, use ----ccccrrrroooopppp 11110000%%%%.
  150.  
  151.            Use cropping to apply image processing options, or
  152.            display,    only a particular area of an image.
  153.  
  154.            Use cropping to crop a particular area of an image.
  155.            Use ----ccccrrrroooopppp 0000xxxx0000 to    trim edges that    are the    background
  156.            color.  Add a x and y offset to leave a portion of the
  157.            trimmed edges with the image.
  158.  
  159.            The equivalent X    resource for this option is
  160.            ccccrrrrooooppppGGGGeeeeoooommmmeeeettttrrrryyyy (class CCCCrrrrooooppppGGGGeeeeoooommmmeeeettttrrrryyyy).  See XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for
  161.            details.
  162.  
  163.       ----ddddeeeellllaaaayyyy <_1/_1_0_0_t_h_s _o_f _a    _s_e_c_o_n_d>_x<_s_e_c_o_n_d_s>
  164.            display the next    image after pausing.
  165.  
  166.            This option is useful for regulating the    display    of the
  167.            sequence    of images.  _1/_1_0_0_t_h_s _o_f    _a _s_e_c_o_n_d must expire
  168.            before the display of the next image.  The default is
  169.            6/100 of    a second between each frame of the image
  170.            sequence.  The second value is optional.     It specifies
  171.            the number of _s_e_c_o_n_d_s to    pause before repeating your
  172.            animation sequence.
  173.  
  174.       ----ddddeeeennnnssssiiiittttyyyy <_w_i_d_t_h>_x<_h_e_i_g_h_t>
  175.            vertical    and horizontal resolution in pixels of the
  176.            image.
  177.  
  178.            This option specifies an    image density when decoding a
  179.            Postscript or Portable Document page.  The default is
  180.            72 pixels per inch in the horizontal and    vertical
  181.            direction.
  182.  
  183.       ----ddddiiiissssppppllllaaaayyyy _h_o_s_t:_d_i_s_p_l_a_y[._s_c_r_e_e_n]
  184.            specifies the X server to contact; see XXXX((((1111)))).
  185.  
  186.       ----ddddiiiitttthhhheeeerrrr
  187.            apply Floyd/Steinberg error diffusion to    the image.
  188.  
  189.            The basic strategy of dithering is to trade intensity
  190.            resolution for spatial resolution by averaging the
  191.            intensities of several neighboring pixels.  Images
  192.  
  193.  
  194.  
  195.      Page 3                        (printed 12/17/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      aaaannnniiiimmmmaaaatttteeee((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    MMMMaaaayyyy 1111999999994444))))        aaaannnniiiimmmmaaaatttteeee((((1111))))
  203.  
  204.  
  205.  
  206.            which suffer from severe    contouring when    reducing
  207.            colors can be improved with this    option.
  208.  
  209.            The ----ccccoooolllloooorrrrssss or ----mmmmoooonnnnoooocccchhhhrrrroooommmmeeee option is required for this
  210.            option to take effect.
  211.  
  212.            Use ++++ddddiiiitttthhhheeeerrrr to render Postscript    without    text or
  213.            graphic aliasing.
  214.  
  215.       ----ggggaaaammmmmmmmaaaa _v_a_l_u_e
  216.            level of    gamma correction.
  217.  
  218.            The same    color image displayed on two different
  219.            workstations may    look different due to differences in
  220.            the display monitor.  Use gamma correction to adjust
  221.            for this    color difference.  Reasonable values extend
  222.            from 0.8    to 2.3.
  223.  
  224.            You can apply separate gamma values to the red, green,
  225.            and blue    channels of the    image with a gamma value list
  226.            delineated with slashes (i.e. 1.7/2.3/1.2).
  227.  
  228.            Use ++++ggggaaaammmmmmmmaaaa to set the image gamma level without
  229.            actually    adjusting the image pixels.  This option is
  230.            useful if the image is of a known gamma but not set as
  231.            an image    attribute (e.g.    PNG images).
  232.  
  233.      _o_f_f_s_e_t>{!}{<}{>}
  234.       ----ggggeeeeoooommmmeeeettttrrrryyyy <_w_i_d_t_h>{%}_x<_h_e_i_g_h_t>{%}{+-}<_x _o_f_f_s_e_t>{+-}<_y
  235.            preferred size and location of the Image    window.     See
  236.            XXXX((((1111)))) for    details    about the geometry specification.  By
  237.            default,    the window size    is the image size and the
  238.            location    is chosen by you when it is mapped.
  239.  
  240.            By default, the width and height    are maximum values.
  241.            That is,    the image is expanded or contracted to fit the
  242.            width and height    value while maintaining    the aspect
  243.            ratio of    the image.  Append an exclamation point    to the
  244.            geometry    to force the image size    to exactly the size
  245.            you specify.  For example, if you specify 666644440000xxxx444488880000!!!! the
  246.            image width is set to 640 pixels    and height to 480.  If
  247.            only one    factor is specified, both the width and    height
  248.            assume the value.
  249.  
  250.            To specify a percentage width or    height instead,    append
  251.            %%%%.  The image size is multiplied    by the width and
  252.            height percentages to obtain the    final image
  253.            dimensions.  To increase    the size of an image, use a
  254.            value greater than 100 (e.g. 125%).  To decrease    an
  255.            image's size, use a percentage less than    100.
  256.  
  257.            Use >>>> to    change the dimensions of the image _o_n_l_y    if its
  258.  
  259.  
  260.  
  261.      Page 4                        (printed 12/17/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      aaaannnniiiimmmmaaaatttteeee((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    MMMMaaaayyyy 1111999999994444))))        aaaannnniiiimmmmaaaatttteeee((((1111))))
  269.  
  270.  
  271.  
  272.            size exceeds the    geometry specification.     <<<<>>>> resizes
  273.            the image _o_n_l_y if its dimensions    is less    than the
  274.            geometry    specification.    For example, if    you specify
  275.            666644440000xxxx444488880000>>>>    and the    image size is 512x512, the image size
  276.            does not    change.     However, if the image is 1024x1024,
  277.            it is resized to    640x480.
  278.  
  279.            When displaying an image    on an X    server,    <_x _o_f_f_s_e_t> and
  280.            <_y _o_f_f_s_e_t> is relative to the root window.
  281.  
  282.            The equivalent X    resource for this option is ggggeeeeoooommmmeeeettttrrrryyyy
  283.            (class GGGGeeeeoooommmmeeeettttrrrryyyy).  See XXXX    RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for details.
  284.  
  285.       ----iiiinnnntttteeeerrrrllllaaaacccceeee _t_y_p_e
  286.            the type    of interlacing scheme: NNNNoooonnnneeee, LLLLiiiinnnneeee, PPPPllllaaaannnneeee, or
  287.            PPPPaaaarrrrttttiiiittttiiiioooonnnn.  The default is NNNNoooonnnneeee.
  288.  
  289.            This option is used to specify the type of interlacing
  290.            scheme for raw image formats such as RRRRGGGGBBBB    or YYYYUUUUVVVV.     NNNNoooonnnneeee
  291.            means do    not interlace (RGBRGBRGBRGBRGBRGB...), LLLLiiiinnnneeee
  292.            uses scanline interlacing
  293.            (RRR...GGG...BBB...RRR...GGG...BBB...), and PPPPllllaaaannnneeee uses
  294.            plane interlacing (RRRRRR...GGGGGG...BBBBBB...).
  295.            PPPPaaaarrrrttttiiiittttiiiioooonnnn is like plane except the different planes are
  296.            saved to    individual files (e.g.    image.R, image.G, and
  297.            image.B).
  298.  
  299.            Use LLLLiiiinnnneeee, or PPPPllllaaaannnneeee to create an interlaced GIF or
  300.            progressive JPEG    image.
  301.  
  302.       ----mmmmaaaapppp _t_y_p_e
  303.            display image using this    _S_t_a_n_d_a_r_d _C_o_l_o_r_m_a_p type.
  304.  
  305.            Choose from these _S_t_a_n_d_a_r_d _C_o_l_o_r_m_a_p types:
  306.  
  307.            best
  308.            default
  309.            gray
  310.            red
  311.            green
  312.            blue
  313.  
  314.            The _X _s_e_r_v_e_r must support the _S_t_a_n_d_a_r_d _C_o_l_o_r_m_a_p you
  315.            choose, otherwise an error occurs.  Use lllliiiisssstttt as the
  316.            type and    aaaannnniiiimmmmaaaatttteeee((((1111)))) searches the    list of    colormap types
  317.            in top-to-bottom    order until one    is located. See
  318.            xxxxssssttttddddccccmmmmaaaapppp((((1111)))) for one way of creating _S_t_a_n_d_a_r_d _C_o_l_o_r_m_a_p_s.
  319.  
  320.       ----mmmmoooonnnnoooocccchhhhrrrroooommmmeeee
  321.            transform the image to black and    white.
  322.  
  323.       ----rrrreeeemmmmooootttteeee _s_t_r_i_n_g
  324.  
  325.  
  326.  
  327.      Page 5                        (printed 12/17/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      aaaannnniiiimmmmaaaatttteeee((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    MMMMaaaayyyy 1111999999994444))))        aaaannnniiiimmmmaaaatttteeee((((1111))))
  335.  
  336.  
  337.  
  338.            execute a command in an remote display process.
  339.  
  340.            The only    command    recognized at this time    is the name of
  341.            an image    file to    load.
  342.  
  343.       ----rrrroooottttaaaatttteeee _d_e_g_r_e_e_s{<}{>}
  344.            apply Paeth image rotation to the image.
  345.  
  346.            Use >>>> to    rotate the image _o_n_l_y if its width exceeds the
  347.            height.    <<<< rotates the image _o_n_l_y if its    width is less
  348.            than the    height.     For example, if you specify ----99990000>>>> and
  349.            the image size is 480x640, the image is not rotated by
  350.            the specified angle.  However, if the image is 640x480,
  351.            it is rotated by    -90 degrees.
  352.  
  353.            Empty triangles left over from rotating the image are
  354.            filled with the color defined as    bbbboooorrrrddddeeeerrrrccccoooolllloooorrrr (class
  355.            bbbboooorrrrddddeeeerrrrCCCCoooolllloooorrrr).
  356.  
  357.       ----sssscccceeeennnneeee _v_a_l_u_e{-_v_a_l_u_e}
  358.            image scene number.
  359.  
  360.            Use this    option to specify an image sequence with a
  361.            single filename.    See the    discussion of _f_i_l_e below for
  362.            details.
  363.  
  364.       ----ssssiiiizzzzeeee    <_w_i_d_t_h>{%}_x<_h_e_i_g_h_t>{%}{+_o_f_f_s_e_t}{!}
  365.            width and height    of the image.
  366.  
  367.            Use this    option to specify the width and    height of raw
  368.            images whose dimensions are unknown such    as GGGGRRRRAAAAYYYY, RRRRGGGGBBBB,
  369.            or CCCCMMMMYYYYKKKK.     In addition to    width and height, use ----ssssiiiizzzzeeee to
  370.            skip any    header information in the image    or tell    the
  371.            number of colors    in a MMMMAAAAPPPP image file, (e.g. -size
  372.            640x512+256).
  373.  
  374.       ----ttttiiiittttlllleeee _s_t_r_i_n_g
  375.            assign a    title to the displayed image.
  376.  
  377.            Use this    option to assign a specific title to the
  378.            image.  This is assigned    to the image window and    is
  379.            typically displayed in the window title bar.
  380.            Optionally you can include the image filename, type,
  381.            width, height, or scene number in the label by
  382.            embedding special format    characters.   Embed %%%%ffff for
  383.            filename, %%%%dddd for    directory, %%%%eeee for filename extention,
  384.            %%%%tttt for top of filename, %%%%mmmm for magick, %%%%wwww for width, %%%%hhhh
  385.            for height, %%%%pppp for page number, %%%%ssss for scene number, or
  386.            %%%%bbbb for file size    in kilobytes.  For example,
  387.  
  388.             -title "%m:%f %wx%h"
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                        (printed 12/17/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      aaaannnniiiimmmmaaaatttteeee((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    MMMMaaaayyyy 1111999999994444))))        aaaannnniiiimmmmaaaatttteeee((((1111))))
  401.  
  402.  
  403.  
  404.            produces    an image title of MMMMIIIIFFFFFFFF::::bbbbiiiirrrrdddd....mmmmiiiiffffffff 555511112222xxxx444488880000 for
  405.            an image    titled bbbbiiiirrrrdddd....mmmmiiiiffffffff and whose width is 512    and
  406.            height is 480.
  407.  
  408.       ----ttttrrrreeeeeeeeddddeeeepppptttthhhh _v_a_l_u_e
  409.            Normally, this integer value is zero or one.  A zero or
  410.            one tells aaaannnniiiimmmmaaaatttteeee to choose a optimal tree depth    for
  411.            the color reduction algorithm.
  412.  
  413.            An optimal depth    generally allows the best
  414.            representation of the source image with the fastest
  415.            computational speed and the least amount    of memory.
  416.            However,    the default depth is inappropriate for some
  417.            images.    To assure the best representation, try values
  418.            between 2 and 8 for this    parameter.  Refer to
  419.            qqqquuuuaaaannnnttttiiiizzzzeeee((((9999)))) for more details.
  420.  
  421.            The ----ccccoooolllloooorrrrssss or ----mmmmoooonnnnoooocccchhhhrrrroooommmmeeee option is required for this
  422.            option to take effect.
  423.  
  424.       ----vvvveeeerrrrbbbboooosssseeee
  425.            print detailed information about    the image.
  426.  
  427.            This information    is printed: image scene    number;     image
  428.            name;  image size; the image class (_D_i_r_e_c_t_C_l_a_s_s or
  429.            _P_s_e_u_d_o_C_l_a_s_s);  the total    number of unique colors;  and
  430.            the number of seconds to    read and transform the image.
  431.            Refer to    mmmmiiiiffffffff((((5555))))    for a description of the image class.
  432.  
  433.            If ----ccccoooolllloooorrrrssss is also specified, the total unique colors
  434.            in the image and    color reduction    error values are
  435.            printed.     Refer to qqqquuuuaaaannnnttttiiiizzzzeeee((((9999)))) for a description    of
  436.            these values.
  437.  
  438.       ----vvvviiiissssuuuuaaaallll _t_y_p_e
  439.            animate images using this visual    type.
  440.  
  441.            Choose from these visual    classes:
  442.  
  443.            StaticGray
  444.            GrayScale
  445.            StaticColor
  446.            PseudoColor
  447.            TrueColor
  448.            DirectColor
  449.            default
  450.            _v_i_s_u_a_l _i_d
  451.  
  452.            The X server must support the visual you    choose,
  453.            otherwise an error occurs.  If a    visual is not
  454.            specified, the visual class that    can display the    most
  455.            simultaneous colors on the default screen is chosen.
  456.  
  457.  
  458.  
  459.      Page 7                        (printed 12/17/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      aaaannnniiiimmmmaaaatttteeee((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    MMMMaaaayyyy 1111999999994444))))        aaaannnniiiimmmmaaaatttteeee((((1111))))
  467.  
  468.  
  469.  
  470.       ----wwwwiiiinnnnddddoooowwww _i_d
  471.            set the background pixmap of this window    to the image.
  472.  
  473.            _i_d can be a window id or    name.  Specify rrrrooooooootttt to select
  474.            X's root    window as the target window.
  475.  
  476.            By default the image is tiled onto the background of
  477.            the target window.   If ----bbbbaaaacccckkkkddddrrrroooopppp or ----ggggeeeeoooommmmeeeettttrrrryyyy are
  478.            specified, the image is surrounded by the background
  479.            color.  Refer to    XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for    details.
  480.  
  481.            The image will not display on the root window if    the
  482.            image has more unique colors than the target window
  483.            colormap    allows.     Use ----ccccoooolllloooorrrrssss to    reduce the number of
  484.            colors.
  485.  
  486.       In addition to those listed above, you can specify these
  487.       standard X resources as command line options:     ----bbbbaaaacccckkkkggggrrrroooouuuunnnndddd,
  488.       ----bbbboooorrrrddddeeeerrrrccccoooolllloooorrrr,    ----bbbboooorrrrddddeeeerrrrwwwwiiiiddddtttthhhh,  ----ffffoooonnnntttt, ----ffffoooorrrreeeeggggrrrroooouuuunnnndddd,
  489.       ----iiiiccccoooonnnnGGGGeeeeoooommmmeeeettttrrrryyyy, ----iiiiccccoooonnnniiiicccc, ----mmmmaaaatttttttteeeeccccoooolllloooorrrr, ----nnnnaaaammmmeeee, or ----ttttiiiittttlllleeee.  See
  490.       XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for details.
  491.  
  492.       Any option you specify on the    command    line remains in    effect
  493.       until    it is explicitly changed by specifying the option
  494.       again    with a different effect.  For example, to animate two
  495.       images, the first with 32 colors and the second with only 16
  496.       colors, use:
  497.  
  498.            animate -colors 32 cockatoo.1 -colors 16    cockatoo.2
  499.  
  500.       Options are processed    in command line    order.    Any option you
  501.       specify on the command line remains in effect    until it is
  502.       explicitly changed by    specifying the option again with a
  503.       different effect.
  504.  
  505.       By default, the image    format is determined by    its magic
  506.       number. To specify a particular image    format,    precede    the
  507.       filename with    an image format    name and a colon (i.e.
  508.       ps:image) or specify the image type as the filename suffix
  509.       (i.e.    image.ps).  See    ccccoooonnnnvvvveeeerrrrtttt((((1111)))) for a list of valid image
  510.       formats.
  511.  
  512.       When you specify XXXX as    your image type, the filename has
  513.       special meaning.  It specifies an X window by    id, name, or
  514.       rrrrooooooootttt.     If no filename    is specified, the window is selected
  515.       by clicking the mouse    in the desired window.
  516.  
  517.       Specify _f_i_l_e as - for    standard input,    If _f_i_l_e    has the
  518.       extension ....ZZZZ or ....ggggzzzz, the file    is uncompressed    with
  519.       uuuunnnnccccoooommmmpppprrrreeeessssssss or    gggguuuunnnnzzzziiiipppp respectively. Precede the image file
  520.       name with | to pipe from a system command.
  521.  
  522.  
  523.  
  524.  
  525.      Page 8                        (printed 12/17/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      aaaannnniiiimmmmaaaatttteeee((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    MMMMaaaayyyy 1111999999994444))))        aaaannnniiiimmmmaaaatttteeee((((1111))))
  533.  
  534.  
  535.  
  536.       Use an optional index    enclosed in brackets after a file name
  537.       to specify a desired subimage    of a multi-resolution image
  538.       format like Photo CD (e.g. img0001.pcd[4]) or    a range    for
  539.       MPEG images (e.g. video.mpg[50-75]).    A subimage
  540.       specification    can be disjoint    (e.g. image.tiff[2,7,4]).  For
  541.       raw images, specify a    subimage with a    geometry (e.g.    -size
  542.       640x512 image.rgb[320x256+50+50]).
  543.  
  544.       Single images    are read with the filename you specify.
  545.       Alternatively, you can animate an image sequence with    a
  546.       single filename.  Define the range of    the image sequence
  547.       with -_s_c_e_n_e.    Each image in the range    is read    with the
  548.       filename followed by a period    (....)  and the scene number.
  549.       You can change this behavior by embedding a pppprrrriiiinnnnttttffff format
  550.       specification    in the file name.  For example,
  551.  
  552.            -scene 0-9 image%02d.miff
  553.  
  554.       animates files image00.miff, image01.miff, through
  555.       image09.miff.
  556.  
  557.       Image    filenames may appear in    any order on the command line
  558.       if the image format is _M_I_F_F (refer to    mmmmiiiiffffffff((((5555))))    and the    sssscccceeeennnneeee
  559.       keyword is specified in the image.  Otherwise    the images
  560.       will display in the order they appear    on the command line.
  561.  
  562.      BBBBUUUUTTTTTTTTOOOONNNNSSSS
  563.       Press    any button to map or unmap the Command widget.    See
  564.       the next section for more information    about the Command
  565.       widget.
  566.  
  567.      CCCCOOOOMMMMMMMMAAAANNNNDDDD WWWWIIIIDDDDGGGGEEEETTTT
  568.       The Command widget lists a number of sub-menus and commands.
  569.       They are
  570.  
  571.           Animate
  572.         Open
  573.         Play
  574.         Step
  575.         Repeat
  576.         Auto Reverse
  577.           Speed
  578.         Faster
  579.         Slower
  580.           Direction
  581.         Forward
  582.         Reverse
  583.           Help
  584.         Help
  585.         Browse Documentation
  586.         About Display
  587.           Image Info
  588.  
  589.  
  590.  
  591.      Page 9                        (printed 12/17/98)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      aaaannnniiiimmmmaaaatttteeee((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    MMMMaaaayyyy 1111999999994444))))        aaaannnniiiimmmmaaaatttteeee((((1111))))
  599.  
  600.  
  601.  
  602.           Quit
  603.  
  604.       Menu items with a indented triangle have a sub-menu.    They
  605.       are represented above    as the indented    items.    To access a
  606.       sub-menu item, move the pointer to the appropriate menu and
  607.       press    a button and drag.  When you find the desired sub-menu
  608.       item,    release    the button and the command is executed.     Move
  609.       the pointer away from    the sub-menu if    you decide not to
  610.       execute a particular command.
  611.  
  612.      KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS
  613.       Accelerators are one or two key presses that effect a
  614.       particular command.  The keyboard accelerators that
  615.       aaaannnniiiimmmmaaaatttteeee((((1111)))) understands is:
  616.  
  617.       CCCCttttllll++++OOOO
  618.            Press to    load an    image from a file.
  619.  
  620.       ssssppppaaaacccceeee
  621.            Press to    display    the next image in the sequence.
  622.  
  623.       <<<<    Press to    speed-up the display of    the images.  Refer to
  624.            ----ddddeeeellllaaaayyyy for more information.
  625.  
  626.       >>>>    Press to    slow the display of the    images.     Refer to
  627.            ----ddddeeeellllaaaayyyy for more information.
  628.  
  629.       FFFF1111   Press to    display    helpful    information about aaaannnniiiimmmmaaaatttteeee((((1111)))).
  630.  
  631.       FFFFiiiinnnndddd Press to    browse documentation about IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk.
  632.  
  633.       ????    Press to    display    information about the image.  Press
  634.            any key or button to erase the information.
  635.  
  636.            This information    is printed: image name;     image size;
  637.            and the total number of unique colors in    the image.
  638.  
  639.       CCCCttttllll----qqqq
  640.            Press to    discard    all images and exit program.
  641.  
  642.      XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  643.       aaaannnniiiimmmmaaaatttteeee options can appear on    the command line or in your X
  644.       resource file.  Options on the command line supersede    values
  645.       specified in your X resource file.  See XXXX((((1111)))) for more
  646.       information on X resources.
  647.  
  648.       All aaaannnniiiimmmmaaaatttteeee options have a corresponding X resource.    In
  649.       addition, the    aaaannnniiiimmmmaaaatttteeee    program    uses the following X
  650.       resources:
  651.  
  652.       bbbbaaaacccckkkkggggrrrroooouuuunnnndddd ((((_c_l_a_s_s BBBBaaaacccckkkkggggrrrroooouuuunnnndddd))))
  653.            Specifies the preferred color to    use for    the Image
  654.  
  655.  
  656.  
  657.      Page 10                        (printed 12/17/98)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      aaaannnniiiimmmmaaaatttteeee((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    MMMMaaaayyyy 1111999999994444))))        aaaannnniiiimmmmaaaatttteeee((((1111))))
  665.  
  666.  
  667.  
  668.            window background.  The default is #ccc.
  669.  
  670.       bbbboooorrrrddddeeeerrrrCCCCoooolllloooorrrr ((((_c_l_a_s_s BBBBoooorrrrddddeeeerrrrCCCCoooolllloooorrrr))))
  671.            Specifies the preferred color to    use for    the Image
  672.            window border.  The default is #ccc.
  673.  
  674.       bbbboooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh ((((_c_l_a_s_s BBBBoooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh))))
  675.            Specifies the width in pixels of    the Image window
  676.            border.    The default is 2.
  677.  
  678.       ffffoooonnnntttt ((((_c_l_a_s_s FFFFoooonnnntttt oooorrrr FFFFoooonnnnttttLLLLiiiisssstttt))))
  679.            Specifies the name of the preferred font    to use in
  680.            normal formatted    text.  The default is 14 point
  681.            _H_e_l_v_e_t_i_c_a.
  682.  
  683.       ffffoooorrrreeeeggggrrrroooouuuunnnndddd ((((_c_l_a_s_s FFFFoooorrrreeeeggggrrrroooouuuunnnndddd))))
  684.            Specifies the preferred color to    use for    text within
  685.            the Image window.  The default is black.
  686.  
  687.       ggggeeeeoooommmmeeeettttrrrryyyy ((((_c_l_a_s_s ggggeeeeoooommmmeeeettttrrrryyyy))))
  688.            Specifies the preferred size and    position of the    image
  689.            window.    It is not necessarily obeyed by    all window
  690.            managers.
  691.  
  692.       iiiiccccoooonnnnGGGGeeeeoooommmmeeeettttrrrryyyy ((((_c_l_a_s_s IIIIccccoooonnnnGGGGeeeeoooommmmeeeettttrrrryyyy))))
  693.            Specifies the preferred size and    position of the
  694.            application when    iconified.  It is not necessarily
  695.            obeyed by all window managers.
  696.  
  697.       iiiiccccoooonnnniiiicccc ((((_c_l_a_s_s    IIIIccccoooonnnniiiicccc))))
  698.            This resource indicates that you    would prefer that the
  699.            application's windows initially not be visible as if
  700.            the windows had be immediately iconified    by you.
  701.            Window managers may choose not to honor the
  702.            application's request.
  703.  
  704.       mmmmaaaatttttttteeeeCCCCoooolllloooorrrr ((((_c_l_a_s_s MMMMaaaatttttttteeeeCCCCoooolllloooorrrr))))
  705.            Specify the color of windows.  It is used for the
  706.            backgrounds of windows, menus, and notices.  A  3D
  707.            effect  is achieved  by using highlight and shadow
  708.            colors derived from this    color.    Default    value: #ddd.
  709.  
  710.       nnnnaaaammmmeeee ((((_c_l_a_s_s NNNNaaaammmmeeee))))
  711.            This resource specifies the name    under which resources
  712.            for the application should be found.  This resource is
  713.            useful in shell aliases to distinguish between
  714.            invocations of an application, without resorting    to
  715.            creating    links to alter the executable file name.  The
  716.            default is the application name.
  717.  
  718.       sssshhhhaaaarrrreeeeddddMMMMeeeemmmmoooorrrryyyy ((((_c_l_a_s_s SSSShhhhaaaarrrreeeeddddMMMMeeeemmmmoooorrrryyyy))))
  719.            This resource specifies whether animate should attempt
  720.  
  721.  
  722.  
  723.      Page 11                        (printed 12/17/98)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      aaaannnniiiimmmmaaaatttteeee((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    MMMMaaaayyyy 1111999999994444))))        aaaannnniiiimmmmaaaatttteeee((((1111))))
  731.  
  732.  
  733.  
  734.            use shared memory for pixmaps.  ImageMagick must    be
  735.            compiled    with shared memory support, and    the display
  736.            must support the    MIT-SHM    extension.  Otherwise, this
  737.            resource    is ignored.  The default is True.
  738.  
  739.       tttteeeexxxxtttt____ffffoooonnnntttt ((((_c_l_a_s_s tttteeeexxxxttttFFFFoooonnnntttt))))
  740.            Specifies the name of the preferred font    to use in
  741.            fixed (typewriter style)    formatted text.     The default
  742.            is 14 point _C_o_u_r_i_e_r.
  743.  
  744.       ttttiiiittttlllleeee    ((((_c_l_a_s_s TTTTiiiittttlllleeee))))
  745.            This resource specifies the title to be used for    the
  746.            Image window.  This information is sometimes used by a
  747.            window manager to provide some sort of header
  748.            identifying the window.    The default is the image file
  749.            name.
  750.  
  751.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  752.       ddddiiiissssppppllllaaaayyyy
  753.            To get the default host,    display    number,    and screen.
  754.  
  755.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  756.       ddddiiiissssppppllllaaaayyyy((((1111)))),,,, iiiimmmmppppoooorrrrtttt((((1111)))),,,, mmmmoooonnnnttttaaaaggggeeee((((1111)))),,,, mmmmooooggggrrrriiiiffffyyyy((((1111)))),,,, ccccoooonnnnvvvveeeerrrrtttt((((1111)))),,,,
  757.       ccccoooommmmbbbbiiiinnnneeee((((1111)))),,,, xxxxttttpppp((((1111))))
  758.  
  759.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  760.       Copyright 1998 E. I. du Pont de Nemours and Company
  761.  
  762.       Permission is    hereby granted,    free of    charge,    to any person
  763.       obtaining a copy of this software and    associated
  764.       documentation    files ("ImageMagick"), to deal in ImageMagick
  765.       without restriction, including without limitation the    rights
  766.       to use, copy,    modify,    merge, publish,    distribute,
  767.       sublicense, and/or sell copies of ImageMagick, and to    permit
  768.       persons to whom the ImageMagick is furnished to do so,
  769.       subject to the following conditions:
  770.  
  771.       The above copyright notice and this permission notice    shall
  772.       be included in all copies or substantial portions of
  773.       ImageMagick.
  774.  
  775.       The software is provided "as is", without warranty of    any
  776.       kind,    express    or implied, including but not limited to the
  777.       warranties of    merchantability, fitness for a particular
  778.       purpose and noninfringement.    In no event shall E. I.    du
  779.       Pont de Nemours and Company be liable    for any    claim, damages
  780.       or other liability, whether in an action of contract,    tort
  781.       or otherwise,    arising    from, out of or    in connection with
  782.       ImageMagick or the use or other dealings in ImageMagick.
  783.  
  784.       Except as contained in this notice, the name of the E. I. du
  785.       Pont de Nemours and Company shall not    be used    in advertising
  786.  
  787.  
  788.  
  789.      Page 12                        (printed 12/17/98)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      aaaannnniiiimmmmaaaatttteeee((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    MMMMaaaayyyy 1111999999994444))))        aaaannnniiiimmmmaaaatttteeee((((1111))))
  797.  
  798.  
  799.  
  800.       or otherwise to promote the sale, use    or other dealings in
  801.       ImageMagick without prior written authorization from the E.
  802.       I. du    Pont de    Nemours    and Company.
  803.  
  804.      AAAACCCCKKKKNNNNOOOOWWWWLLLLEEEEDDDDGGGGEEEEMMMMEEEENNNNTTTTSSSS
  805.       The MIT X Consortium for making network transparent graphics
  806.       a reality.
  807.  
  808.       Michael Halle, Spatial Imaging Group at MIT, for the initial
  809.       implementation of Alan Paeth's image rotation    algorithm.
  810.  
  811.       David    Pensak,    E. I. du Pont de Nemours and Company, for
  812.       providing a computing    environment that made this program
  813.       possible.
  814.  
  815.       Paul Raveling, USC Information Sciences Institute, for the
  816.       original idea    of using space subdivision for the color
  817.       reduction algorithm.
  818.  
  819.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  820.       John Cristy, E.I. du Pont de Nemours and Company
  821.       Incorporated
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.      Page 13                        (printed 12/17/98)
  856.  
  857.  
  858.  
  859.